package cn.song.config;

import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;
import org.springframework.core.task.TaskExecutor;
import org.springframework.scheduling.concurrent.ThreadPoolTaskExecutor;

import java.util.concurrent.ThreadPoolExecutor;

/**
 * 线程池配置类
 * 用于配置异步任务执行的线程池参数，优化系统性能
 *
 * @author SongRenShuo
 * @date 2024/03/05
 */
@Configuration
public class ThreadPoolConfig {

    /**
     * 创建异步任务执行器
     * 配置线程池的核心参数，包括核心线程数、最大线程数、队列容量等
     *
     * @return 配置好的任务执行器
     */
    @Bean(name = "asyncExecutor")
    public TaskExecutor taskExecutor() {
        ThreadPoolTaskExecutor executor = new ThreadPoolTaskExecutor();
        // 设置核心线程数：系统正常运行时的线程数
        executor.setCorePoolSize(5);
        // 设置最大线程数：系统最大能容纳的线程数
        executor.setMaxPoolSize(15);
        // 设置等待队列容量：当核心线程都在运行时，新任务会放入队列等待
        executor.setQueueCapacity(20);
        // 设置线程名称前缀：方便在日志中识别线程来源
        executor.setThreadNamePrefix("Async-Executor-");
        // 设置拒绝策略：当线程池和队列都满时，新任务由调用线程执行，而不是直接抛出异常
        // 这样可以避免任务丢失，但可能会影响主线程性能
        executor.setRejectedExecutionHandler(new ThreadPoolExecutor.CallerRunsPolicy());
        // 初始化线程池
        executor.initialize();
        return executor;
    }
}
